پرش به مطلب اصلی

سفارش مارکت (Market Order)

👋 Introduction​

سفارش مارکت بهت این امکان رو می‌ده تا بلافاصله و با بهترین قیمت موجود در بازار، خرید یا فروش خودت رو انجام بدی.
این نوع سفارش بهت اجازه می‌ده که از تغییرات سریع بازار بهره‌برداری کنی، چون سفارش‌ت فوراً با بهترین قیمت فعلی بازار تکمیل می‌شه.

مثال کاربردی:​

فرض کن می‌خوای 100 واحد از رمزارز تتر (USDT) رو به قیمت بازار بخری. تو این نوع سفارش نیازی به تعیین قیمت نداری و سفارش‌ت به‌سرعت و با بهترین قیمت موجود در بازار تکمیل می‌شه.

🔗 Endpoint​

POST /api/v1/odr/orders/

⏱ Rate Limit​

اطلاعیه

حداکثر تعداد درخواست‌های مجاز برای ثبت سفارش برابر با 5400 درخواست در ساعت هست.

📨 Request​

curl --location --request POST 'https://api.bitpin.ir/api/v1/odr/orders/' \  
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \  
--header 'Content-Type: application/json' \  
--data '{
    "symbol": "USDT_IRT",
    "type": "market",
    "side": "buy",
    "base_amount": 100
}'

🛠 Request Params​

ParameterDescriptionTypeRequiredExample
symbolنام بازار (مثل USDT_IRT)StringبلهUSDT_IRT
typeنوع سفارش (market)Stringبلهmarket
sideساید سفارش (buy یا sell)Stringبلهbuy
base_amountمقدار رمزارز برای خرید یا فروشIntegerخیر100
quote_amountمقدار تومانی یا تتری برای خرید یا فروشIntegerخیر100
هشدار

در سفارش مارکت میتونی base_amount و یا quote_amount رو وارد کنی. ولی دقت کن که فقط یکیشو میتونی بفرستی. اگر هر دو رو بفرستی، بصورت پیشفرض base_amount مورد قبول سیستم قرار میگیره.

Additional Notes​

  • تو سفارش مارکت می‌تونی به جای تعیین مقدار ارز پایه (base_amount)، مقدار ارز مرجع (quote_amount) رو هم تعیین کنی تا بر اساس اون معامله انجام بشه.
  • سفارش بازار برای کسایی مناسبه که می‌خوان سریع معامله کنن و از نوسانات بازار بهره‌برداری کنن.